home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / GSXSAM.ZIP;1 / README.TXT < prev    next >
Encoding:
Text File  |  1993-08-07  |  6.1 KB  |  194 lines
  1. Sample Code for GENSCNRX
  2.  
  3.  
  4.  
  5. The sample FoxPro code files contained in GSXSAMPL.ZIP are designed 
  6. for example use with GENSCRNX.PRG.  The files contained in 
  7. GSXSAMPL.ZIP are for use with FoxPro 2.5, although GENSCRNX.PRG 
  8. is compatible with all versions of FoxPro 2.x.
  9.  
  10.  
  11.  
  12.  
  13. INSTALLATION
  14.  
  15.  
  16. Read documentation on installation supplied with GENSCRNX before 
  17. using the sample code.
  18.  
  19. Notes:
  20. For futher information about GENSCRNX and releated files, refer to 
  21. VERSION.TXT supplied with GENSCRNX.ZIP.
  22.  
  23.  
  24.  
  25.  
  26. UP AND RUNNING
  27.  
  28.  
  29. After unzipping GSXSAMPL.ZIP, execute GSXDEMO.PRG from within 
  30. FoxPro 2.5:
  31. .
  32. To execute GSXDEMO.PRG, enter:
  33. DO GSXDEMO
  34.  
  35. Notes:
  36. CUST0.SCX does not reference the object library while CUST1.SCX, 
  37. CUST2.SCX, CUST3.SCX, and CUST4.SCX do.  Notice the #:INSERT 
  38. directive in the Cleanup snippet of CUST3.SCX.  GENSCRNX executes 
  39. #:INSERT faster than GENSCRN executes #INSERT with the same code 
  40. output.  GENSCRNX also supports the #INSERT screen directive when 
  41. using FoxPro 2.0 with identical specifications as FoxPro 2.5 although 
  42. using #:INSERT is recommended because it is executed faster.
  43.  
  44. Important:
  45. The best way to understand the example screens is to compare the 
  46. object contents using the Screen Builder followed by analysis of the 
  47. generated .SPR files.  Refer to GENSCRNX documentation for directive 
  48. definition.  If changes are made to any object library screen, the object 
  49. library screen must be re-generated. This may be accomplished by using 
  50. the Generate option with the object library screen open or by rebuilding 
  51. the LIBRARY project.  For any object library changes to affect screens in 
  52. the SAMPLE project, open the SAMPLE project and rebuild the project 
  53. using the Rebuild All option.
  54.  
  55.  
  56.  
  57.  
  58. PROJECTS
  59.  
  60.  
  61. LIBRARY.PJX        Object library project
  62.  
  63. Files:
  64. LIBMAIN1.SCX    MAIN object library
  65. LIBACCT1.SCX    ACCT object library
  66.  
  67. Notes:
  68. Files in LIBRARY.PJX may be built individually and are not dependent on 
  69. each other when changes are made.  Although the ACCT library 
  70. references objects contained in the MAIN library, rebuilding ACCT after 
  71. changes are made to MAIN are not required.
  72.  
  73. Important:
  74. Object library screens must re-generated before screens referencing their 
  75. objects (such as screens in the SAMPLE project) can be generated.
  76.  
  77.  
  78. TEMPLATE.PJX    Template project
  79.  
  80. Files:
  81. CUSTINF1.SCX    Customer information template 1
  82. CUSTINF2.SCX    Customer information template 1
  83. SPINNER.SCX        MS-DOS spinner template
  84.  
  85. Notes:
  86. Files in TEMPLATE.PJX may be built individually and are not dependent 
  87. on each other when changes are made.  To suppress the generation of 
  88. unused code from the template screens, the directive *:NOGEN is used 
  89. in the Setup snippet for the screens above.  *:NOGEN is used to make 
  90. updates to the FOXSCX library only without generating an .SPR file.  
  91. Using *:NOGEN with template screens is faster because GENSCRN is 
  92. not called.
  93.  
  94. Important:
  95. Template screens never have to be generated since they are used for 
  96. importing only.  The project is only used as a filing cabinet only and does 
  97. not require building at any time.
  98.  
  99.  
  100. SAMPLE.PJX        Sample project
  101.  
  102. Files:
  103. CUST0.SCX        Customer sample 0
  104. CUST1.SCX        Customer sample 1
  105. CUST2.SCX        Customer sample 2
  106. CUST3.SCX        Customer sample 3
  107. CUST4.SCX        Customer sample 4
  108. CUST5.SCX        Customer sample 5
  109. CUST6.SCX        Customer sample 6
  110. CUST7.SCX        Customer sample 7
  111.  
  112. Notes:
  113. Files in SAMPLE.PJX may be built individually and are not dependent on 
  114. each other when changes are made.  CUST0.SCX is a typical screen 
  115. that does not define or reference any objects and does not used any 
  116. GENSCRNX directives.  CUST0.SCX is used to demonstrate how a 
  117. FoxPro screen built without GENSCRNX directives creates an identical 
  118. .SPR as when compiled without _GENSCRN=GENSCRNX.PRG.
  119.  
  120.  
  121.  
  122.  
  123. DRIVERS
  124.  
  125.  
  126. WINMOVE.PRG    Window move driver
  127.  
  128. Notes:
  129. The WINMOVE driver is used to automatically add code necessary to 
  130. move the screen window off the screen by 800,800 at the end of the 
  131. Setup snippet and back again at the end of the READ Show clause.  This 
  132. is useful (especially in FoxPro for Windows) when the READ Show 
  133. clause has a visual delay when executing the .SPR and having it 
  134. suppressed is desirable.  The WINMOVE driver can be specified by 
  135. adding *:SCXDRV2 WINMOVE in the Setup snippet.  Refer to 
  136. CUST5.SCX for an example of the WINMOVE driver.
  137.  
  138. NOSIZE.PRG        No SIZE clause driver
  139.  
  140. Notes:
  141. The NOSIZE driver is used to automatically remove the SIZE clause from 
  142. all screen objects (except for objects directly specifying the *:SIZE 
  143. directive).  This is useful when a field lengths change dynamically at 
  144. runtime and proper execution requires the SIZE clause to be left out of 
  145. the GET command.  The NOSIZE driver can be specified by adding 
  146. *:SCXDRV3 NOSIZE in the Setup snippet.  Refer to CUST5.SCX for an 
  147. example of the NOSIZE driver.  
  148.  
  149. CONTROLS.PRG    Controls driver
  150.  
  151. Notes:
  152. The CONTROLS driver is used to execute the *:SPINNER. The 
  153. CONTROLS driver can be specified by adding *:SCXDRV2 CONTROLS 
  154. in the Setup snippet.  Refer to CUST3.SCX for an example of the 
  155. CONTROLS driver.
  156.  
  157.  
  158.  
  159.  
  160. COPYRIGHT NOTICE
  161.  
  162.  
  163. Compressed file: GSXSAMPL.ZIP
  164. System: GenScrnX
  165. Author: Ken R. Levy
  166. Company: Jet Propulsion Laboratory
  167. Copyright: None (Public Domain)
  168.  
  169. All source code and documentation contained in GSXSAMPL.ZIP was 
  170. developed at the Jet Propulsion Laboratory in Pasadena, Calif. and has 
  171. been placed into the public domain.  You may use, modify, copy, 
  172. distribute, and demonstrate any source code, example programs, or 
  173. documentation contained in GSXSAMPL.ZIP freely without copyright 
  174. protection.  You may not resell any source code, example programs, or 
  175. documentation contained in GSXSAMPL.ZIP.  All files contained in 
  176. GSXSAMPL.ZIP are provided 'as is' without warranty of any kind.  In no 
  177. event shall its authors, contributors, or distributors be liable for any 
  178. damages.
  179.  
  180.  
  181.  
  182.  
  183.  
  184. COMMENTS/SUGGESTIONS/PROBLEMS/QUESTIONS
  185.  
  186.  
  187. Please use CompuServe's FoxForum (section 3rd Party Products) 
  188. directed to:
  189.  
  190. Ken Levy 76350,2610
  191.  
  192. -----------------------------------------------------------
  193.  
  194.